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COPYRIGHT STATEMENT 
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WIMAC is not a stand-alone product and consequently is not 
supported as such by WICAT Systems. Tliis manual is provided to 
aid those who need to interface WIMAC with a programming language. 
WICAT assumes no responsibility for the use of WIMAC (as an 
interface or any other way) since it is not supported as a 
stand-alone product. 



The software described in this manual is provided in accordance 
with a license agreenent and may be used or oopied only as 
indicated under the terms of such license. 



WICAT Systems Incorporated assunes no responsibility for the use 
or reliability of software on equipment not supplied by WICAT. 



MANUAL INTENT STATEMENT 



The purpose of this manual is to help users in program 
development. Ihe information contained in the manual is subject 
to change without notice and should not be construed as a 
ocmmitment by WICAT Systems Incorporated. WICAT Systems 
Incorporated assunes no responsibility for any errors that may 
appear in this manual. 
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WiMAC Version: 1.0 



**** NOTICE **** 

Hiis manual describes the WICAT Macro Assembler version 
1.0 and later. Version 1.0 of WiMAC supports UniPlus+ 
System V OOFF and LL object formats. Ihis version does 
not support macros or the WMCS command line format. WiMAC 
runs under the following operating systems: 



WMCS 5.0 

Uniplus+ System V 1.0 



o Appendix A lists the ASai character set that can be used 
in assembler programs. 

o Appendix B lists error messages produced by the assembler. 
An explanation and probable cause for each error is also 
givQi. 

o Appendix C 

o i^:pendix D order. 

o Appendix E lists the 68000 instruction set in alphabetical 
order. 

o Appendix F 



MANUAL a»IVENTIDNS 

A description of the symbolic conventions used throughout this 
manual follows. Familiarize yourself with these conventions 
before you continue to read. • 

The following conventions are observed: 

o Examples consist of actual assembler programs or program 
f ragnents wherever possible. 

o Uppercase words and letters r when used in examples r 
indicate that the word or letter must be typed exactly as 
sho^n. 

o Lowercase words and letter, when used in format examples, 
indicate that you are to substitute a word or value of your 
choice. 

o Square brackets ([]) indicate that the enclosed iten(s) 
is (are) optioral. The square brackets are not entered as 
part of any option, they are shown only to aid in the 
description of the syntax. 

o Braces ({}) indicates that the enclosed item(s) can be 
repeated zero or more times as a group. The braces are not 
entered as part of the repetitions, they are shown only to 
aid in the description of the syntax. 

o The angle brackets (<>) indicate that tiie item enclosed 
must be supplied by the user. For items that require 
numeric values, the values are interpreted as decimal, 
unless otherwise stated or modified. The angle brackets 
are not entered as part of item, they are shewn only to aid 
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SUMMARY OF TECHNICAL CHi^NGES 



Hiis manual dooinents WiMAC version VI. 0. Ihe following 
technical changes are new to this release: 



CHANGES 
None - A new release. 

ENHANCEMEN1S 
None - A new release. 

FIXED BUSS 
None - A new release. 



PREFACE 



MANDAL CBJECTIVES 

Ihe intent of this publication is to provide sufficient 
information to develop assembly language programs on VllCkT 
computer systems. Ihe information contained in this manual 
pertains to the usage and syntax of the assembler only. 



MANUAL STRUCTURE 

Ihis manual is organized into ten chapters and seven 
appendices, as follows: 

o Qiapter 1 introduces the features of the WICAT macro 
assembler. 

o Chapter 2 

o Chapter 3 e^^jlains hoii to use the assembler on the 
appropriate operating system (WMCS, UniPlus+ System V) . 

o Chapter 4 describes the listing file produced fcy the 
assenbler. 

o Chapter 5 covers the format used in the assembler source 
statements. 

o Chapter 6 describes the components of a assembler source 
statements: the character set; symbols; nunbers; and 
expressions. 

o Chapter 7 e^^lains the general directives (pseudo-opcodes) . 
Pseudo-opcodes discussed in this chapter include listing 
control, symbol control, data definition and storage, and 
program sectioning. 

o Chapter 8 

o Chapter 9 



in the description of the s^tax. 



CHAETER 1 
INTOOrUCTION 

[TO be written later] 
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CHAPTER 2 
FEATDRES 

[To be written later] 
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CHAPTER 3 
INVOKING THE ASSEMBLER 



3.1 WMCS OPERATING SYSTEM 



**** NOTE **** 

At the time of this writing, WiMAC is used only to 
assenhle compiler generated programs. It is not intended 
to be used directly by the user. Therefore, all 
invocation of WiMAC should be done by the GDMPILE utility. 
Refer to the Wicat Multi-user Control System fWMCS^ User's 
Reference )vt?^n^iai for complete documentation on the use of 
COMPILE. 



3.2 tJNIPLDSf SYSTEM V OIERATING SYSTEM 



**** NOTE **** 



At the time of this writing, WiMAC is used only to 
assemble compiler generated programs. It is not intended 
to be used directly by the user. Therefore, all 
invocation of WiMAC should be done by the CC(1) utility. 
Refer to the Wicat UniPlus+ Systgn V User's Manual 
(Section 1) for complete documentation on the use of 
CC(1) . 
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INVOKING IHE ASSEMBLER 
Dli^NOSnC MESSMES 



3 .3 DIAGNOSTIC MESSAGES 
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CHAETER 4 
LISTING FILE 

The listing file produced by the assembler can consist of the 
following five parts: 

o Assemfcily source statements 

o SymiDol table (optional) 

o Program section tables (optional) 

o Cross-reference table (optional) 

o Assembly sunmary (optional) 

Sections 4.1 through 4.5 describe each of these parts. Section 
4.6 contains an example of a listing file. 

4.1 ASSEMBLY SCDRCE STATEMENTS 

Ihe assembly source statanents comprise the main part of the 
listing file, and consists of: 

o I^ge Headers 

o Source lines with hexadecimal code 

o Error and informational messages (if applicable) 

Each is described below. 
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4.1.1 Page Header 

The assembler prints a new page in the listing file when it 
encounters a .EfiGE direc±ive in the source, when it encounters a 
new page (form feed) in the source file, or when the existing page 
of the listing file is filled. On the top of each page in the 
listing file, the assembler prints five header lines. 



The first line of the header oontains the following information: 

o Assembler name 

o Assembler configuration 

o Assembler version nunaber 

o Date the listing f iLe was generated 

o Time the listing file was generated 

o Listing page nimber 

Ihe assembler configuration string consists of three fields. Ihe 
first field indentifies the host operating system, lypical values 
are UNIX, WMCS, etc. . The second field lists the input format. 
The final field shows the output format. Ihe currently defined 
output formats are LL and COFF. 

Ihe second line of the header contains the following inf conation: 
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o Wicat proprietary statenent (if applicable) (See .LIST WICAT) 

o Source file name. 

Hie third line of the heacfer contains a user-supplied message. If 
no message has been supplied, this line is left blank. See the 
.HEZUDER directive for more information. 

The fourth line is blank. 

The fifth line contains the source- line colimn headers. 

4.1.2 Source Statsnents With Hexadecimal Code 

This section is the main part of the listing; it contains the 
source lines and the binary code generated for each line. 



The hexadecimal code is printed with the lowest address on the 
left. The code listed for an instruction contains, from left to 
right: 

o The opcode 

o Ihe first operand (if applicable) 

o Ihe second operand (if applicable) 

o The third operand (if applicable) 

The binary code for data storage is listed from left to right. 
The number of data items that are listed on one line depends on 
the size of the data type as shewn in table 4-1. 
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Table 4-1: Data T/pes per Line 



Data lype I Nimber of Items per Line 



Byte 

Word 

Long 

C3iaracters 

Quac3word 



1 (double precision real) 



Continuation lines will be added as necessary. 

If an expression contains an externally-defined symbol, the 
assembler evaluates the expression by assigning a value of zero to 
that symbol. 

Table 4-2 sunmaries the source line listing format. 



Table 4-2: Source Line Listing Format 



Colimn I Header 



Description 



1-5 


Line 1 


7-14 


Address 1 


16-19 


Oped 1 


21-39 


Operands 1 


41- 


Source Statement I 



Source line number (decimal) 
Location counter (hexadecimal) 
Opcode (hexadecimal) 
Operands (hexadecimal) 
Source line 
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4.1.3 Error And Informational Messages 

4.2 SYMBOi TABLE 

Ihe symbol table lists all symbols, except permanent symbols, that 
are defined or referenced in the module, ihe symbols are listed 
by order of appearance in a module. Each new level of nested 
symbols is indented two spaces. 



4.3 PROGRAM SECTION TABLES 

The program section tables lists the program sections, their 
names, their size, and their attributes. This information is 
presented in two tables, the first table lists all named program 
sections. This list is in the order in which they were defined. 
This tables also includes any predefined section names. The 
second table oonsists, all defined sections listed in nimeric 
order, followed by their size and attributes. See the .SECT 
directive for a complete description of the attributes. All 
section numbers and sizes are listed both in decimal and 
hexadecimal radix. Decimal nunibers always appear with a decimal 
point (.) after the nunUDer. 



4.4 CROSS-REFERENCE TABLE 

[Not implemented in this version] 

4.5 ASSEMBLY SUMMARY 

[Not implemented in this version] 

4.6 EXAMILE LISTING 

This section shows a complete listing file (figure 4-1) generated 
by assembling the source program listed in figure 4-1. 
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CHAPTER 5 
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An assembly source program oonsists of a sequence of source 
statements, each of which occupies exactly one line. Multiple 
statements on a single line are not allowed. Each line can be up 
to 254 characters long (not including the line terminator) . 
Hcwever, no line should exceed 80 characters to ensure that the 
source fits on one line in the listing file. 

A source line consist of four basic fields: label, opcode, 
operand and comment. Ihe general format of an assembler line is: 




Spaces and tabs are allowed anywhere in the line, except inside 
labels, opcodes, symbols and nimbers. At least one space or tab 
must appear between opcode and operand fields. Blank lines are 
accepted, but have no significance or meaning. All characters 
that have an ASQI value of space or less are treated as a space, 
with the exception of line feed (^J) and form feed CD . 
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5.1 LABEL FIELD 

A label is a user-defined symbol that references a specific 
location within a progrcm. This symbol is assigned the value 
equal to the current location counter. Ihe value of symbol may be 
absolute or relative depending on the type of section that it is 
defined in. 

A label is a symbol that can contain i^jpercase letters (A-Z) , 
lowercase letters (a-z) , digits (0-9) , underline (_) , dollar sign 
($) and period (.) characters. A label cannot start with a nimber 
or a dollar sign. A label must be terminated with a colon ( : ) and 
conform to all the rules that govern user-defined symbols (see 
section 6.2.2) . Ihis field is optional. 

dice a label is defined within a module or a begin/end block, it 
cannot be redefined in that module or block. If a label is 
defined more that once, the assembler displays an error message 
where the label was defined and again where it was redefined. All 
labels are local to the module that they are defined in, unless 
they are exported out of the module with the .GLCBAL directive. 

Only one label per source line is allowed. However, multiply 
labels may have the same value. For example: 

labell: 
. Iabel2: 
labels : nop 

all have the same value (which is the address of the "nop" 
instruction) . 

All labels that apply to directives (see chapter 7) , must be on 
the same line as the directive. For example: 

foo: .const 10 

and 

foo: 

.const 10 

are not equivalent. Ihe second ".const" declaration will result 
in an error (Label required) . 
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5.2 OPOOEE FIELD 

The opcode field specifies the action to be performed by the line. 
This field may contain either an instruction mnemonic, an 
assembler directive, or a macro call. Assembler directives are 
indicated ty beginning with a period (.) • This style enables the 
user to quickly identify assembler directives from actual machine 
instructions. See Appendix E for a complete list of instructions 
mnemonics. Chapter 7 describes the assembler directives and macro 
calls. 



5.3 OPERAND FIELD 

The operand field contains operands for the instruction or 
arguments for an assembler directive or macro call. The operand 
field must be separated from the opcode field by a least one 
delimiter. A delimiter is typically a space or tab, however, any 
character with an ASCII value of space (hexadecimal 40) or less 
(except line feed Cj) and form feed Cl)) is considered a 
delimiter. When two or more operand appear within a statement, 
they must be separated ty a comma (,) . 



5.4 COMMENT FIELD 

The conment field contains text that describes the function of the 
line. This field must start with a semicolon (;) and be 
terminated fcy the end-of-line diaracter. Conments can start 
anywhere on a line, including colimn 1. The comment field m^ 
contain ai^ printable ASCII character (see Appendix A) . Comments 
are included in the assembly listing but, otherwise, are ignored 
by the assembler. 
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This chapter describes the various oomponents of the assembler 
source statement. Ohese components consist q£ characters, 
symbol Sr nunnbersr strings r and expressions. 



6.1 (BARACTER SET 

The characters that can be used in assembler source statanents are 
listed in Table 6-1. All control characters and DEL are treated 
as delimiters (spaces) , except line feed (^J) and form feed (^L) . 
Ihe null character (^@) should be avoided, for it causes premature 
intermination of listing source lines. 



Table 6-1: Legal Assembler Characters 



Character 



Character Name 



Function 



^J 
^ 



Line feed 
Form feed 
Space 

Exclamation point 
Double quote mark 
Nuniber sign 
Dollar sign 

Percent sign 



Line terminator 

Page advance 

Opcode/Operand field delimiter 

Logical NOT operator 

String indicator and terminator 

Immediate data indicator 

Hexadecimal radix indicator 
and character in symbol name 

Remainder operator (modulus) 
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Table 6-1 (Cont. ) : Legal Assembler Qiaracters 



Character I Character Name 



Function 



/ 



0..9 



Ampersand 
Single Quote Mark 

Left Parenthesis 

Right Parenthesis 

Asterisk 

Plus 

Ccnima 
Minus 

Period 

Slash 

Digits 

Colon 

Semicolon 

Left-angle bracket 
Equal sign 
Right-angle bracket 
Question mark 



Bitwise AND operator 

Character literal indicator 
and terminator 

E:q>ression grouping delimiter 
and register indirection indicator 

Expression grouping delimiter 
and register indirection indicator 

Arithmetic multiplication and 
current location counter 

Autoincrement, unary plus, 
and arithmetic addition 

Operand and paraneter separator 

Autodecronent, unary minus, 
arithmetic subtraction, and 
register range (MCVEM instr) 

Character in symbol name and 
real nunber decimal point 

Arithmetic division and 
register separator (MOVEM instr) 

Nimbers and characters in symbol 
names 

Label terminator and expression 
qualifier 

Comment field indicator 

Less than operator 

Equals operator 

Greater than operator 

Defined operator 
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Table 6-1 (Cont. ) : Legal Assembler Characters 



Character 



Character Name 



Function 



@ 


At sign 1 


La • Z 


Uppercase letters 1 


[ 


Right-square | 
bracket i 


\ 


Backslash I 


] 


Left-square | 
bracket j 


A 


Circumflex 1 





Underline 1 


> 


Reverse Apostrophe j 


L..Z 


Lowercase letters I 


{ 


Left brace 1 


1 


Vertical bar 1 


} 


Right brace 1 


~ 


Tilde 1 



Reserved for future use 
Characters in symbol names 
Reserved for future use 

Escape character indicator 
Reserved for future use 

Bitwise XDR operator 
Character in symbol name 
Unary operator delimiter 
Characters in symbol names 
Reserved for future use 
Bitwise OR operator (exclusive) 
Reserved for future use 
I's complement operator 



6.2 SXMBCLS 

Ti^o types of symbols can be used in assembly programs: permanent 
symbols and user-defined symbols. Each is described belcw. 



6.2.1 Permanent Symbols 

Permanent symbols consist of specific processor instruction 
mnsmonics (see Appendix E) , assembler directives (see Chapter 7) 
and register names (see Table 6-2) . These symbols need not be 
defined before being used. Instruction mnemonics and assembler 
directives are reserved symbol names and cannot be redefined by 
the user. 
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All permanent symbols are converted internally to i^jpercase. 
example: 



For 



move dOrdl 
MOVE DOfDl 
Move dOrDl 



are all the same instruction and registers. 

The registers of the 68000 microprocessor must be referenced as 
described in Table 6-2. Lcwercase register names are allowed, but 
are mapped internally into i^jpercase register names. 



Table 6-2: Assembler Register Names 



Register Nane i 68000 Register 



D0-D7 

A0-A7 

SP 

SSP 

USP 

PC 

CCR 

SR 



Data registers 

Address registers 

Stack Pointer registers (A7) 

Supervisor Stack Pointer register (A7) 

User Stack Pointer register 

Progrsni Counter 

Condition Code Register 

Status Register 



A complete description of these registers may be found in the 
Motorola MC68QQQ 16- Bit Microprocessor User's Manual. 



6.2.2 User-Defined Symbols 

A user-defined symbol is a string of alphanumeric characters. Ihe 
general fonnat for a user-defined symbol is: 
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-(J^^n 





I 






The following rules govern the creation of user-defined symbols: 



1. User-defined symbols can be composed of uppercase letters 
(A-Z) , la/ercase letters (a-z) , digits (0-9) , underlines (_) , 
dollars ($) and periods (.)• 

2. The first character of a symbol must begin with a letter 
(A-Z,arz) , underline (_) r or a period (.) • It cannot begin 
with a nunber or a dollar sign. 

3. No embedded spaces or other characters are allowed in a 
symbol. 

4. There is no limit to the length of a symbol, however, the 
input source line is limited to 254 characters, thereby 
indirectly limiting the length of a symbol to 254 characters. 

User-defined symbols can be used as labels, variables, module 
names, section names, and macro names. These user-defined symbols 
can also be equated to a specific value by the .ABSADR, .ADDR or 
.ODNST directives (see Chapter 7) and used in any expressions (see 
Section 6.6) , 

Siymbols can have absolute (constant) or relative values. 



6.2.3 Nsme Spaces 

The assembler si^jports several differ oit name spaces. Name 
conflicts only occur in the same rame space. This is to say, 
identical symbol names can coexist in different name spaces 
without conflict. The following name spaces are si^jported: 

o Data Structure Names 
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o Module and Block Names 

o Section Nanes 

o Label and Variable Names 

o P&cro Names 

6.2.4 Case Gon^^ersion 

Case conversion of user-defined symbols is controlled by the 
".ENABLE UPEER", ".ENABLE LCWER" and ".ENABLE MIXED" directives. 
When the ".ENi^LE UPPER" directive is encountered, all subsequent 
user-defined symbols are converted to uppercase. The ".ENABLE 
LCWER" directive cause all subsequent user-defined symbols to be 
converted to lowercase. When the ".ENABLE MIXED" directive is 
encounter, no case conversion is performed. The default is 
".ENABLE MIXED". Table 6-3 sunmarizes the effect of the various 
case conversion directives. 

Table 6-3: Case Conversion Directives 



Directive 



Description 



.ENABLE LCWER 

.DISABL LCWER 
.ENABLE UPPER 

.DISABL UPIER 
.ENABLE MIXED 

.DISABL MIXED 



Convert all subsequent user-defined symbols to 
lOf/ercase. 

Return to MIXED mode. 

Convert all subsequent user-defined symbols to 
uppercase. 

Return to MIXED mode. 

No case conversion of subsequent user-defined 
symbols is performed. 

Ignored. 



Case conversion only applies to user-defined symbols. Permanent 
symbols are alw^s mapped to i^jpercase. See chapter 7 for more 
information on the ".ENABLE" directive. 
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6.2.5 Determining Symbol Values 

•Hie value of a symbol depends on hew it was defined or used in the 
assembly program. 



6.3 NDMBERS 

Nunber can be integers, character literals, or reals. Integers 
and character literals are treated identically, and interpreted as 
integer numbers. All three types of nunnbers are described below. 

Numbers are always treated as absolute (constant) values. 



6 .3 .1 Integers 

•Uie general format for integer numbers is: 







bi*\ar^^ 
«pe razors 


— 


bm^ry 
























octal 
ope^'Ators 


— 


octnl 

dibits 


— 




























\i\ 








.dccivMiii 


dcc«ifM«) 


1 


' 








; 


1 




















hex 
operators 


— 




^ 






















mt - rtftl 
opeVAtors 


— 


rea\ 







Integers must be in the range of -2,147,483,648 to +2,147,483,647 
for signed ntmbers or in the range of to +4,294,967,295 for 
unsigned numbers. 

The assembler translates all negative ntmbers into 2's oompiLQment 
form. Negative numbers must be preceded by a minus sign. For 
positive nunber s, the plus sign is optional. 

Ihe assembler interprets all integers in the source progrsm as 
decimal unless the nuonber is preceded by a radix control operator. 
See section 6.6.1.1 for a description of the radix operators. 

Integers can be used in expressions or as a single values. 
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6.3.2 Character Literals 

Oiaracter literals are a string of i?) to four characters (bytes) 
that are enclosed fcy single quote marks ( ' ) . The general format 
for character literals is: 




■\cl^artttter7* 







number 



\ 





Character literals of more than four characters are illegal and 
are reported as errors. The high order bit of each character in 
the literal is cleared (parity bit set to zero) . This done to 
prevent sign extension of characters that are moved into 
registers. 

All character literals are considered internally as integer 
nimbers. 



Character literals can be used any 
alleged. 



where an integer number is 



Character literals are always considered as 
values. 



absolute (constant) 
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6 .3 .3 Reals 

The general format for a real number is: 










The decimal point can appear anywhere to the right of the first 
digit. However r a real nunaber cannot start with a decimal point. 
A real minber can be specified with or without an e3q»nent. 

Real nimbers can be single-precision (32-bit) or double precision 
(64-bit) . The precision of single precision nunbers is 6-7 digits 
and 15-16 digits for double precision. 

The assembler converts all real nunbers into standard IEEE format. 
A complete description of the internal real format can be found in 
Appendix D. 

Real nun[ibers can only be used in the .DC.F and .DC.D directives. 
Real nuo[ibers cannot be used in e:5)ressions or with any unary or 
binary operators, with the exception of unary minus, unary plus 
and and the unary operators ^R, ^T, ^F, ^U and ^L. 



6.4 STRINGS 

Character strings are a string of up to 254 characters (bytes) 
that are enclosed fcy double quote marks ("). Ohe general format 
for character strings is: 
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-^ 






*(^^^t^y^-(^^ 



number 





Any ASai character except the line feed and double quote iriark 
characters can appear directly within the string. All characters 
in the string are converted to their 8-bit ASQI value, and the 
high order bit is always cleared (parity bit set to zero) . It is 
not recommend that non-printable (control) character be typed 
directly into the character string. Any character, including 
null, line feed, double quote and control characters, can be 
included in a character string, ty "escaping" the character. An 
"escaped" character is introduced fcy the backslash character (\) . 
The character inmediately following the backslash is included in 
the string. Any of the radix control operators and floating point 
operator that return an integer can follow the backslash 
character. In this case, the character whose value is represented 
by the number is inserted into the character string. All nunbers 
represented in this way are truncated to an 8-bit value. Finally, 
if the character inmediately following the backslash is the 
circumflex character O , then the next character is treated as a 
control character. Ihis is the recommend w^ of inserting control 
or non-printing character into a character string. 

Ihe assembler performs no case conversion on strings. Ihe 
assembler does not autcmatically insert ary character at the end 
of the string. 

A null string is r^resented ty two consecutive double quote marks 
("") and has a length of zero. 



6.5 LOCATICN aXKriER 

Ihe current location counter always has the value of tiie address 
of tiie current byte. Ihe assembler symbol for the location 
counter is the asterisk (*) . The assembler sets the current 
location counter at the beginning of each new program section (see 
.SECT - Chapter 7) . The location counter may be set or changed fcy 
use of the following directives: 
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1. .MODULE <name> 

2. .SECT <section> 

3. .SECT <section> ,ADDE?ESS = <expression> 

4. .ALIGN <keyword> [,<fill>] 

5. .ALIGN <expression> [,FILL>] 

6. .DS.x <expression> [,<fill>] 



When the current location counter is used in the operand field of 
an instruction, the current location counter has the value of the 
address of the beginning of the instruction — it does not have 
the value of the address of the operand. 

Asterisk has an absolute value if used in a absolute section, 
otherwise it has a relative value. 



6.6 GENERAL EXPRESSIONS 

Expressions consist of constants, absolute syinbols, relative 
symbols, external symbols, functions, and operators. Constants 
and absolute symbols can be used with any of the operators and 
have no limitations on their usage in expressions. Relative and 
external symbols can only be used with tiie addition and 
subtraction operators in simple expression. Section 6.6.3 
descibes where these symbols are legal. The legal operators are 
fully described in section 6.6.1. 

The assembler evaluates expressions from left to right with the 
operator precedence rules described in Table 6-11. However, 
parentheses () can be used to change the order of evaluation. Any 
portion of an e:q)ression that is enclosed in parentheses is first 
evaluated to a single value, which is then used in evaluating the 
complete e^qjression. 

All e:q)ressions are evaluated as signed 32HDit values. Ihe result 
of any expression with an error is zero. 
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6.6.1 Operators 

Operators perform a specific function on an expression. All 
operators accept only interger nunbers or character literals as 
operands, with tiie exceptions of the real nunber operators (^R, 
^T, ^F, ^U, and ^L) , which accept floating-point nunnber as 
operands. The result of all operators is a 32-bit signed integer 
nunber. 

The assembler operators are broken up into the following six 
categories: 

1. Radix Control Operators 

2. Real Number Operators 

3. Arithmetic Operators 

4. Bitwise Operators 

5. Logical Operators 

6. Relational Operators 

Each is described belcw. 
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6.6.1.1 Radix Control Operators - The assembler accepts numbers 
in four different radixes: binary, octal, decimal, and 
hexadecimal. The default radix is decimal. The general format 
for the radix control operators is: 





. biwarY 

di<^iH 


" 








. octal 










deciimal 
d(^»t5 




' 




J 


1 








diaits 


^ 








' digits 





For oompatibility with previous assemblers, the dollar sign ($) 
can be used to specified the hexadecimal radix. Hie legal 
characters for each radix are listed belcw. 



Table 6-4: Legal Radix Characters 



Format I Radix 



I Legal Characters 



^B 


Binary 1 


^0 


Octal ! 


^D 


Decimal | 


^H 


Hexadecimal | 


$ 


Hexadecimal | 



and 1 

through 7 

through 9 

through 9, A through F, and a through f 

through 9, A through F, and a throuc^ f 



Radix control operators can be included in the source progrsm 
anywhere a nuneric value is legal. A radix control operator 
affects only the nunber immediately following it. 

Ihe reverse apostrophe C) cannot be separated from the B, 0, D, 
and H character that follows it, but the radix operator can be 
separated fcy spaces or tabs from the nunber that follows it. 

Table 6-5 sunmarizes the radix control operators. 
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Table 6-5: Radix Control Operators 



Operator i Operator Name | Operation 



^B 


Binary 


Binary value 


^0 


Octal 


Octal value 


^D 


DecLmal 


Decimal value 


^H 


Hexadecimal 


Hexadecimal value 


$ 


Dollar sign 


Hexadecimal value 
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6.6.1.2 Real Nunber Operators - Real nunber operators accept real 
number arguments and return an integer number. The real nunber 
operators are useful because it allows real numbers to be used in 
e:5)ressions and instructions that accept only integers. See 
section 6.3.3 for the format of real nunbers. 

Real nunber operators can be included in the source program 
anywhere a nuneric value is legal. A real nunber operator affects 
only the nunber immediately following it. 

Ihe reverse apostrophe C) cannot be separated from the R, T, F, 
U, and L character that follows it, but the real operator can be 
separated fcy spaces- or tabs from the real nunber that follows it. 

Table 6-6 sunmarizes the real nunber operators. 



Table 6-6: Real Nunber Operators 



Operator 


Operator Name 


Operation 


^R 


Round 


Round real nunber to the nearest 
integer. 


^T 


Truncate 


Truncate real nunber to its integer 
part. 


^F 


Coerce 


Change apparent type of a single- 
precision (32-bit) real number to a 
long integer (32-bit) . 


^L 


Double Lower 


Extract as an integer the lower 
32-bits of a double-precision 
(64-bit) real nunber. 


^U 


Double Upper 


Extract as an integer the upper 
32-bits of a dDuble-precision 
(64-bit) real nunber. 
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6.6.1.3 Arithmetic Operators - Ihe arithmetic operators perform 
the usual arithmetic conversion on their operanc3s. 

The assembler prints a warning message if division by zero occurs. 

Table 6-7 sunmarizes the arithmetic operators. 



Table 6-7: Arithmetic Operators 



Operator I Operator Name | Operation 



/ 
% 



Plus sign 
Minus sign 
Plus sign 
Minus sign 
Asterisk 
Slash 
Per Gent 



Positive (unary) 

Negative (unary) 

Addition 

Subtraction 

Multiplication 

Division 

Renainder 
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6.6.1.4 Bitwise Operators - The bitwise operators 
usual bito/ise conversion on their operands. 



perform the 



The shift operators are used to perform left and right arithmetic 
shifts. The first operand is shifted left or right ty the nunber 
of bit positions specified in the second operand. When the first 
operand is shifted left, the lew-order bits are set to zero. When 
the right ^if t operator is used and the first operand is signed, 
the high-order bits are set to the value of the orignal high-order 
bit (sign bit) (arithmetic shift) . When the right shift operator 
is used and the first operand is unsigned the high-order bits are 
set to zero (logical shift) . 

Table 6-8 summarizes the bitwise operators. 



Table 6-8: Bitwise Operators 



Operator I Operator Nane I Operation 



» 



« 



Tilde 

Mpersand 

Exclamation 

Vertical bar 

Right angle 
brackets 

Left angle 
brackets 



l*s aomplement value 
Bitwise MD 
Bitwise OR (inclusive) 
Bitwise OR (exclusive) 
Shift right 

Shift left 
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6.6.1.5 Logical Operators - Logical operators return a one (1) if 
the the result of the operation is true, and zero (0) if the 
result of the operation is false. 

Table 6-9 summarizes the logical operators. 



Table 6-9: Logical Operators 



Operator | Operator Nane | Operation 



] 
? 

&& 




Logical NOT operator 
Defined operator 
Logical AND operator 
Logical OR operator 
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6.6.1,6 Relational Operators - Relational operators return a one 
(1) if the the result of the operation is true, and zero (0) if 
the result of the operation is false. 

Table 6-10 suranarizes the Relational operators. 



Table 6-10: Relational Operators 



Operator I Operator Name I Operation 



= 


Equal 


Equal 


<> 


Not equal 


Not equal 


• ^ 


Not equal 


Not eqiHl 


< 


Less than 


Less than 


<= 


Less than 
or equal 


Less than or eqijal 


> 


Greater than 


Greater than 


>= 


Greater than 
1 or ftjnal 


Greater than or equal 
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6.6.1.7 Operator Precedences And Associativity - Table 6-11 
suranarizes the operator precedences and associativity in the 
assembler. These operators are listed in order of decreasing 
precedence. Operators grouped together have the same precedence 
and are associated f ran left to right. 



Table 6-11: Operator Precedence 



Operator | Function 



^0 

$ 
^R 

^T 
^F 



I 

* 

/ 

% 

& 

&& 

« 

» 



< 

<= 

> 

>= 

<> 



Binary value operator 
Octal value operator 
Decimal value operator 
Hexadecimal value operator 
Hexadecimal value operator 
Round real operator 
Truncate real operator 
Coerce real operator 
Upper real operator 
Lower real operator 

Unary plus operator 
Unary minus operator 
I's complonent operator 
Logical NOT operator 
Symbol defined operator 

Multiplication operator 
Division operator 
Ranainder operator 
Bitwise AND operator 
Logical AND operator 
Shift left operator 
Shift right operator 

Addition operator 
Subtraction operator 
Bitwise exclusive OR operator 
Bitwise inclusive OR operator 
Logical OR operator 

Less than operator 

Less than or equal operator 

Greater than operator 

Greater than or equal operator 

Not equal operator 

Not equal operator 

Equal operator 



Highest Precedence 



Lowest Precedence 
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6.6.2 Expression 

An expression consists either a simple e:q)ression or a simple 
e:^ression followed ty any of the relational operators followed by 
another simple expression. All relational operators have equal 
precedences. E:^ressions can be grouped for evaluation fcy 
enclosing them in pareitheses. The enclosed expressions are 
evaluated first, and all ronaining operations are performed from 
left to right. 

Relative and external values are not allowed as operands to 
relational operators. 

Figure 6-7 simmaries the syntax of expressions. 




6.6.3 Simple Expressions 

A simple expression consists either a term or a sign followed ty a 
term or a simple expression followed by of the simple operator 
followed by a term. All simple operators have equal precedences. 
Simple e:^ressions can be grouped for evaluation by enclosing than 
in parentheses. The enclosed simple expressions are evaluated 
first, and all ronaining operations are performed from left to 
right. 
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Relative and external values are not allowed as operands to simple 
operators with the exception of binary plus and minus operators. 
Table 6-12 sunmarizes the use of relative and external values in 
these operators. 



Table 6-12: 



Operation 



Result 



Absolute + Absolute 


Absolute 




Absolute + Relative 


Relative 




Absolute + External 


External 


- Relative 


Relative + Absolute 


Relative 




Relative + Relative 


ERROR 




Relative + External 


ERROR 




External + Absolute 


External 


- Relative 


External + Relative 


ERROR 




External + External 


ERROR 




Absolute - Absolute 


Absolute 




Absolute - Relative 


ERROR 




Absolute - External 


ERROR 




Relative - Absolute 


Relative 




Relative - Relative 


Absolute 


* 


Relative - External 


ERROR 




External - Absolute 


I External 


- Relative 


External - Relative 


I ERROR 




External - External 


1 ERROR 





* If and only if both relative values are defined in the same 
module and sectionr otherwise, the result is an ERROR. 



Figure 6-8 sunroaries the syntax of simpLe expressions. 
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6.6.4 Terms 

A term consists either a factor or a term followed by a term 
operator followed ty a factor. All term operators have equal 
precedences. Terms can be grouped for evaluation ty enclosing 
then in parentheses. Ihe enclosed term are evaluated first, and 
all renaining operations are performed from left to right. 

Relative and external values are not allowed as operands to term 
operators. 



Figure 6-9 sunmaries the syntax of term, 




6.6.5 Factors 

A factor consists of any of the following: 

1. Nunnber 

2. Symbol 

3. Current location counter (*) 

4. One's campliment operator (") 

5. Logical NOT operator (!) 

6. Defined symbol operator (?) 

7. An expression enclosed by parenthesis 
Figure 6-10 sunmaries the syntax of factors, 
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^' integer 




e)C^eiSiov\ 




■factor 



•fuctor 



S^vAbo) 
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The general assembler directives (pseudo-opcodes) provide 
facilities for performing various assembler functions. Table 7-1 
lists these functions and the directives in each category. The 
reniainder of this chapter describes the directives in detail, 
shewing their formats and giving examples of their use. For ease 
of reference, the directives are presented in alphabetical order 
in this chapter. In addition. Appendix C contains a sunnmary of 
all assembler directives. 

Assembler directives are written in the same way as instructions, 
but (with the exception of the .DC.x and .DS.x directives) do not 
cause ar^ code to be generated. All assembler directives begin 
with a period (.). Ihis style of naming directives enables the 
user to quicJcly identify assembler directives f ran actual machine 
instructions. 



Table 7-1: Assembler Directive Sunmary 



Category 



Directives 



Assembler Option 
Directives 

Listing Control 
Directives 



Message Display 
Directives 



.DISABL 
.ENABLE 

.HEADER 
.LIST 
.NCLIST 
.£»GE 

• ERROR 
.FATAL 
.PRINT 
.WARM 
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Table 7-1 (Cont.) : Assembler Directive Suranary 



Category 



Directives 



Module and Block 


.RFniN 


Directives 


•END 




.MDDDT.E 


Program Sectioning 


.SECT 


Directive 




Symbol Assignment 


•ABSAER 


Directives 


•ADER 




.UUNSr 


Symbol Attribute 


.EXTERN 


Directives 


.GLOBAL 




.LOaVL 




.NCNUSR 




.USER 




.WEAK 


Data Definition 


.ENDS 


Directives 


.yiMJCT 


Data Storage 


.DC.x 


Directives 


.DS.x 




.OOMMDN 


Location Control 


.ALIGN 


Directive 




Conditional Assembly 


1 .FT.SE 


Directives 


.ENDC 




.IF 


Miscellaneous 


.(TWFIG 


Directives 


.EOF 




1 .1?TLE 




1 .INCLD 




1 .r.TNE 




.LINKER 




.PROCSS 



7-2 



ASSEMBLER DTRECriVES 
**** PRELIMINARy - For internal use only **** 

Any directives may have a label, seme require it. If a directive 
requires a laisel, the label must appear on the same line as the 
directive. For example: 

foo: .const 10 

and 

foo: 

.const 10 

are not equivalent. The first case shews a valid label for the 
.CONST directive. In the second case, "foo" is not a label for 
the .ODNST directive and this case will cause in an assembler 
error (Label required) . 
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.ABSAER .ABSAER 



NAME: .ABSADR — Absolute address definition directive. 
FORMAT: <label> .ABSAER <address> [,<domain>] 

PARAMETERS: 

<address> = any legal expression. The e:q)ression can contain 
forward references but cannot contain any external, 
relative, or unresolved symbols. The expression 
must evaluate to an assemble- time constant. 

<danain> = ai^ legal expression. Bie expression can contain 
forward references but cannot contain any external, 
relative, or unresolved symbols. The expression 
must evaluate to an assemble- time constant. The 
domain must be in the range of through 254. Ihe 
default domain value is zero. Ihis parameter is 
optional. 



EESCEUPFION: The .ABSADR directive is used to assign an absolute 
address to the user symbol in the label field. This 
is particularly useful when writing software that 
accesses absolute address in an address space. An 
example of this is device drivers that must directly 
ccmmunicate to device specific locations. Ihese 
locations can be in memory (memory mapped I/O) , or 
on an I/O bus, or in seme other address space. Ihe 
<dcmain> parameter is used to specify a specific 
address space. This form is used only on machines 
that support multiple address spaces (e.g. I/O 
buses) . A domain of zero is considered the native 
or host address space and is the default. 

An absolute address is treated internally fcy the 
assembler as a signed constant. 



NOOES: 



1. This directive must appear inside a module (see 
• MODULE) . 
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**** 



.ABSAm 



(Continued) 



.ABSADR 



2. A label is required ty this directive. The <label> 
cannot be defined anywhere else at this module 
level. 

3. This directive is not si^jported by all object file 
formats. Refer to Appendix F for specific object 
file limitations. 
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.ADER .ADER 



NZ\ME: .ADER — Address definition directive. 

FORMAT: <label> .ADDR <address> 

PARAMETERS: 

<address> = any legal expression. The e:5)ression can contain 
forward references and relative symbols but cannot 
contain any external or unresolved symbols. 



EESCRIETION: "Hie .ADER directive assigns the value of the address 
expression to the user symbol in the label field. 
Ihe value of tiie expression is relative to the 
beginning of the section in which the definition 
appears. If the definition appears in an absolute 
section, the symbol is assigned the value of an 
absolute address (see .ABSADR) , otherwise the symbol 
value is assigned a relative value. 

.ADDR performs the same function as a: progran label 
definition, except .ADDR can appear anywhere within 
the section. The .ADER directive performs an out of 
line address definition, a label definition is an in 
line address definition. For example the following 
code segments are equivalent. 

.sect 10 .sect 10 

bra foo bra foo 

foo: .addr * + 100 

.ds.b 100 .ds.b 100 

nop foo: nop 

An address value is treated internally by the 
assembler as a signed constant. 



NOOES: 



1. Ihis directive must appear inside a section (see 
.SECT) . 
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.ADER (Continued) .ADER 



2. A label is required by this directive. The <label> 
cannot be defined anywhere else at this module 
level. 
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.ALIGN .ALIGN 



NAME: .ALIGN — Align location oounter directive. 



FORMAT: .ALIGN <address> [,<fill>] 

.ALIGN <keyword> [,<fill>] 



PARAMETERS: 

<address> = ar^ legal e:q)ression. The expression cannot contain 
are/ forward references, external symbols, relative 
symbols, or unresolved symbols. The ea^ression must 
evaluate to an assemble-time constant in the first 
pass. 

<keyword> = any keyword listed in Table 7-2. Either the long 
form or short form of the keyword may be used. 



<f ill> = any legal expression. Ihe expression can contain 
forward references, but cannot contain any external, 
relative, or unresolved symbols. The expression 
must evaluate to an assemble-time constant. The 
fill value must be in the range of through 255. 
Ihe default fill value is zero. Ihis parameter is 
optional. 



DESaHPriC^: The .ALIGN directive aligns the location counter to 
the boundary specified fcy either tiie <address> or 
the <keyword> paraneter. If the <address> parameter 
is used, the location counter is set to the value of 
the <address> expression. If the <keyword> 
parameter is used, the location counter is aligned 
to the address that is the next multiple of the 
value listed in Table 7-2 under "Size in Bytes". If 
the optional <f ill> value is supplied, the bytes 
skipped fcy the location counter (if any) are filled 
with the specified value, otherwise, the bytes are 
zero filled. If the fill value is larger than 255, 
the value is truncated and a warning message is 
printed. 
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.ALIGN 



(Continued) 



Table 7-2; 



.ALIGN 



Long 
Form 



Short 
Form 



Size in 
Bytes 



Description 



EVEN 



E7 



ODD 



OD 



BYTE 



BY 



The EVBI keyword 
ensures that the 
current value of 
the location 
counter is even. 
If the location 
counter is odd, 
EVEN will add one 
to the its value. 
If the location 
counter is alreac^ 
even, no action is 
taken. 

The ODD keyword 
ensures that the 
current value of 
the location 
counter is odd. 
If the location 
counter is even, 
ODD will add one 
to the its value. 
If the location 
counter is alreac^ 
odd, no action is 
taken. 

Align the location 
counter to a byte 
boundary. This 
keyword performs 
no action. 
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.ALIGN 



(Continued) 



Table 7-2: 



.ALIGN 



Long 
Form 



Short 
Form 



Size in 
Bytes 



Description 



WORD 



WD 



LCNG 



LG 



PAGE 



PG 



4096 



Align the location 
counter to a word 
boundary. If the 
current is aligned 
to a word no 
action is taken. 
•This is equivalent 
to the EVEN 
keyword. 

Align the location 
counter to a long 
word boundary. If 
the current value 
is aligned to a 
long word, no 
action is taken. 

Align the location 
to a page boundary. 
If the current 
value is aligned 
to a page, no 
action is taken. 



NOTES: 



1. This directive must appear inside a section (see 
.SECT) . 

2. If a label is specif iedr it is assigned the 
value of the location counter jasffitfi any 
aligning is performed. 
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.BEGIN .BEGIN 



NAME: .BEGIN — Begin block directive. 
FORMAT: .BEGIN [<name>] 

PARAMETERS: 

<name> = any legal user-defined symbol. The default name is 
the null name (a null string) . This parsmeter is 
optioiHl. 



EESCRIETION: The .BEGIN directive is used to start a new symbol 
scoping level. It does not change the value of the 
location counter. 

If the optional <name> is specif iedr it cannot be 
defined anywhere else in the activating module. A 
name ^ould be specified in the .BEGIN directive and 
in the corresponding .END directive, so that the 
assembler can detect any improperly nested scoping 
blocks. 

This directive is similar in function to an inner 
block in the C language. 



NOTES: 



1. This directive must appear inside a module (see 
.MODULE) . 

2. If a label is specified, it is assigned the 
current value of the location counter. 
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.OOMMDN .GOMMDN 



NAME: .OOMMDN — Common region definition directive, 

FORMAT: .OOMMDN <name> [,<size>] 

PARAMETERS: 

<name> = any legal user-defined symbol. 

<size> = any legal expression. The e:^ression can contain 
forward references but cannot contain any external, 
relative, or ixiresolved symbols. The expression 
must evaluate to an assemble-time constant. The 
size must be a positive value. ^e default size 
value is zero. This pargmeter is optional. 



EESCRIPTION: The .OOMMDN directive defines <name> as a common 
region with length of <size> bytes. For commons 
with the same name and different sizes, the largest 
size is used. No storage is allocated for common 
regions by the assembler, this is done by the 
linker. The space reserved by the .GOMMDN directive 
is considered "out-of-line" storage allocation, the 
user has no control over the placement of this 
space. 



NOTES: 



1. This directive must appear inside a section (see 
.SECT) . 

2. The space allocated by the common directive is 
not necessarily allocated in the currently 
defined section. Appendix F describes where 
common regions are placed by the various 
linkers. 
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.OONFIG .GONFIG 



NAME: .OCaJFIG — Configuration directive. 

FORMAT: .GCNFIG "<c»nfiguration_string>" 

PARAMETERS: 

<conf iguration_string> = any legal character string. Null strings 
are not allowed. 



EESC3lIFria5 : The .GCNFIG directive places the specified 
configuration string (without the double quotes (")) 
into the object file. This information can be used 
by the various linkers and loaders. Ihe assembler 
does not enforce any format or structure on this 
string. The format and structure of the 
configuration string are specified ty the linkers 
and loaders. Refer to Appendix F for the effects of 
this directive on specific object files. 



NOTES: 



1. The double quotes (") are not part of the 
configuration string. 

2. This directive is not supported fcy all object 
file formats. Refer to Appendix F for specific 
object file limitations. 
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.aXiSI .GCNST 



NAME: .O^sr — Constant symbol definition directive. 
FORMAT: <label> .CDNST <constant> 

PARAMETERS: 

<constant> = any legal es^ression. The expression can contain 
forward references but cannot contain any external, 
relative, or unresolved symbols. The e:5)ression 
must evaluate to an assemble- time constant. 



DESCRIETION: The .OCNST directive assigns the value of the 
constant e:q)ression to the symbol in the label 
field. ,CCM3I! can appear outside module 
definitions. This directive is useful for assigning 
values to conditional assembly symbols. 



NOTES: 



1. A label is required by this directive. The 
<label> cannot be defined anywhere else at this 
module level. 

2. A .OONSr directive can appear any where in the 
user's program. 
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,DC.x 



.DC.x 



NAME: 



.DC.x — Data storage directive. 



EDRMAT: 


.DC.B 




.DC.W 




.DC.L 




.DC.F 




.DC.D 


PARAMETTIRS: 




<constant> = 


= any 



<c»nstant> {,<constant>} 
<constant> {,<constant>} 
<constant> {,<c»nstant>} 
<fp_oonstant> {,<fp_cx>nstant>} 
<fp_oonstant> {,<fp— constant>} 



legal expression or character string. !Ihe 
e:q)ression can oontain forward referencesr external 
symbolSr and relative symbols but cannot contain any 
unresolved symbols. Null character strings are 
allowed, but allocate no space. External and 
relative symbols are resolved at link-time. 



<f p_oonstant> = any legal 
allowed. 



real number. Expressions are not 



EESaHETION: The .DC directive stores a fcyte, word or long 
integer, or a float or double real nunber. If the 
<constant> is an expression, the expression is 
evaluated as a 32-bit value. If this value is 
larger than the allocated space, the constant is 
truncated and a warning message is printed. If 
multiple constants are specified, they must be 
separated by commas. 



Ihe space reserved ty the .DC directive 
considered "in-line" storage allocation. 



IS 
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.DC.x 



(Continued) 



.DC.x 



Table 7-3: 



NOTES: 



Directive 


Nane 


Range of Values Alla/ed 


.DC.B 


Byte 


-128 to +255 


.DC.W 


Word 


-32768 to +65535 


.DC.L 


Long 


-2147483648 to +4294967295 


.DC.F 


Float 


8.43E-37 to 3.37Ef38 


.DC.D 


Double 


4.19E-307 to 1.67Ef308 




***i 


" WARNING **** 



At link-time, a relocatable value or 
expression can result in value that exceeds 
the specified size. Not all linkers will 
issue a truncation warning message. 



1. This directive must appear inside a section (see 
.SECT) . 
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**** 



.DISABL 



.DISABL 



NAME: 



.DISABL — Function control directive. 



FORMAT: 



.DISABL <keyword> {,<keyword>} 



PARAMETERS: 
<keyword> 



any keyword listed in Table 7-4. Either the long 
form or diort form of the keyword can be used. 



EESCRIETICa^: 



•Hie .DISABL directive disables, or inhibitSr the 

specified assembler function. .DISABL is the 

negative form of .ENABLE. Refer to Table 7-4 for 
specific functions. 

If multiple keywords are used, they must be 
separated by commas. 







Table 7-4: 




Long 


Short 


Default 




Form 


Form 


Condition 


Description 


EXl'EKNAL 


EX 


Disabled 


When EXTERNAL is 
disabled, any 
undefined symbol 
that is not listed 
in a .EXTERN 
directive causes 
an error. 


USER 


US 


Enabled 


When USER is 
disabled, any 
symbol that is not 
listed in a .USER 
directive is 
considered a 
NCNUSEK symbol 
(see .NCNUSEK) 
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**** 



.OISABL 



(Continued) 



•DISABL 



Table 7-4: 



Long 
Form 



Short 
Form 



Default 
Condition 



Description 



UPIER 



UC 



Disabled 



LOWER 



LC 



Disabled 



MIXED 



LOCAL 



MC 



LS 



Enabled 



Disabled 



When UPIER is 
disabled, mapping 
of user-defined 
symbols to upper- 
case is terminated 
and no case mapping 
is performed on 
subsequent 
user-defined 
symbols (return 
to MIXED mode) . 

When LOWER is 
disabled, mapping 
of user-defined 
symbols to lower- 
case is terminated 
and no case mapping 
is performed on 
subsequent 
user-defined 
symbols (return 
to MIXED mode) . 

This keyword is 
ignored in the 
.DISABL directive. 

When LOCAL is 
disabled, all 
subsequently 
defined local 
symbols are 
removed from the 
object file symbol 
table. 
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**** 



•DISABL 





(Continued) 

Table 7-4: 


.DISABL 






Long 
Form 


Short I Default 
Form j Condition 


Description 


NCNDSR 
CROSS 


NS 1 Disabled 
CR 1 Enabled 


When NCNUSR is 
disabled, all 
subsequently 
defined local 
symbols are 
ronoved from the 
object file symbol 
table. 

Not implemented. 



NOTES: 



1. 
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**** 



.E6.X 



.DS.x 



NAME: 



.DS.x — Storage allocation directive. 



FORMAT; 



.DS.B <size> [,<fill>] 

.DS.W <size> [r<fill>] 

.DS.L <size> [,<fill>] 

.DS.S <size> [,<fill>] 



PARAMETERS: 



<size> = any legal expression. The expression cannot contain 
any forward references, external symbolSr relative 
symbolSr or unresolved symbols. Ihe expression must 
evaluate to an assanble-time constant in the first 
pass. 

<f ill> = any legal expression. The expression can contain 
forward references but cannot contain any external, 
relative, or unresolved symbols. The expression 
must evaluate to an assanble-time constant. The 
fill value must be in the range of throu^ 255. 
Ihe default fill value is zero. This parameter is 
optional. 



EESCRIPTION: 



Each .DS directive allocates storage for the 
different data types. The value of <size> 
determines the nimber of data itans for which the 
assembler reserves storage. Ihe total nunber of 
tytes reserved is equal to the length of the data 
type (see Table 7-5) multiplied ty the value of 
<size>. If the optional fill value is specified, 
then each data location is initialized to that 
value. Otherwise, the data locations are 
initialized to zero. 



The space reserved fcy the .DS directive 
considered "in-line" storage allocation. 



IS 
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•OS.x 



(Continued) 



•DS.x 



T^hle 7-5: 



Directive i Name 



Nimber of Bytes Allocated 



NOIES: 



.DS.B 


Byte 


1 * value of <size> 


.DS,W 


Word 


2 * valiae of <size> 


.DS.L 


Long 


4 * value of <size> 


.DS.S 


Struct 


1 * size of structure 



1. Ihis directive must appear inside a section (see 
.SECT) . 
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.ELSE .ELSE 



NAME: .ELSE — Conditional assembly else directive, 

EDRMAT: .ELSE 

PARAMETERS: None. 



EESCRIPTICN: The .ELSE directive begins the optional ELSE block 
of tiie .IF directive. If the e^^ression in the 
corresponding .IF directive evaluates to zero, the 
statements bett/eei the .ELSE and the corresponding 
.ENDC are assembled. Otherwise the statenents are 
skipped. 



NOTES: 

1. 
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.ENABLE 



.ENABLE 



NAME: 



.ENABLE — Function control c3irective. 



FORMAT: 



.ENABLE <keyvrorc3> {,<keyword>} 



PARAMETERS: 
<keyword> 



any keyword listed in Table 7-6. Either the long 
form or short fonn of the keyword can be used. 



EESaHPTIO^: The .ENABLE directive enables the specified 
assembler functions. .ENABLE and its negative form, 
.DISABL, control the functions listed in Table 7-6 
assembly functions. Refer to Table 7-6 for specific 
functions. 

If multiple keywords are used, they must be 
separated fcy commas. 



Table 7-6: 



Long 


Short 


Default 




Form 


Form 


Condition 


Description 


EXTERNAL 


EX 


Disabled 


When EXTERNAL is 
enabled, all 
undefined symbols 
are considered 
EXL'ERNAL symbols 
(see .EXTERN) . 


USER 


US 


Enabled 


When USER is 
enabled, any 
symbol that is not 
listed in a 
.NCNUSR directive 
is considered a 
USER symbol (see 
.USER) . 
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.ENABLE 





(Continued) 


.ENABLE 




Table 7-6: 




Long 1 


Short 1 Default 




Form 


Form 1 Condition 


Description 


UPPER 1 


UC 1 Disabled 


When UPIER is 
enabledr all 
subsequent user- 
defined syiitols 
are mapped to 
uppercase. 


LO^ER 1 


LC 1 Disabled 


When LCWER is 
enabledr all 
subsequent user- 
defined symbols 
are mapped to 
lowercase. 


MIXED 


MC 1 Enabled 


When MIXED is 
enabled, any 
case-conversion 
options (UPPtIR, 
LCWER) is 
terminated and 
all subsequent 
user-defined 
1 symbols are 
1 not converted. 


LOCAL 


1 LS 1 Disabled 


1 When LOCAL is 

enabledr all 
1 subsequent 
1 user-defined 
LOCAL symbols 
1 (see .LOCAL) 
are included 
1 in the object 
1 file symbol 
1 table. This 
1 function is 
1 useful when 
1 debugging. 
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•k*ieie 



.mPBLE 





(Continued) 


.ENART.R 




Table 7-6: 




Long 


Short 1 Default 




Form 


Form 1 Conc3ition 


Description 


NCNUSR 


NS 1 Disabled 


When NCNUSR is 
enabled, all 
subsequent 
user-defined 
NCNUSR symbols 
(see .NCNUSR) 
are included 
in the object 
file symbol 
table. This 
function is 
useful when 
debugging. 


CROSS 


CR 1 Enabled 


1 Not implemented. 



NOTES: 



1. 
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.ZNDC .INDC 



NAME: .PNDC — Conditional assembly end directive, 
FORMAT: .ENDC 
PARAMETERS : None . 



DESC3lIEriQN: The .ENDC directive terminates the conditional 
assembly block started ty the .IF directive. See 
the description of .IF for more information. 



NOTES: 



1. 
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.£ND ,mD 



NAME: .END — Module and block end directive. 
FORMAT: .END [<name>] 

PARAMETERS: 

<name> = any legal user-defined symbol. This parenieter is 
optional. 



EESCRIITION: .END terminates a .M3IIJLE or .BEGIN definition. If 
.END is encountered without a corresponding .MDDULE 
or .BEGIN directive, the assembler displ^s an error 
message. If the optional name is specif ied, it must 
matdi tiie name defined in the corresponding .MDEULE 
or .BEGIN directive. Ihe use of the name is 
strongly recommended so that the assembler can 
detect any improperly nested modules or begin 
blocks. 



NOOES: 

1. 
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.ENDS .ENDS 



NAME: .ENDS — Structure definition end directive. 

EORMAT: .ENDS [<:name>] 

PAE^AMEIIERS: 

<name> = any legal user-defined symbol. This parsmeter is 
optional. 



EESCRIETIDN: The .ENDS directive terminates a structure 
definition started hy the .sraDCT directive. See 
the description of .SIHDCP for more information. If 
the optional name is specified, it must match the 
name defined in the corresponding .SIRUCT directive. 
The name should be specified so that the assembler 
can detect any improperly nested structures. 



NOTES: 

1. 
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.BOP .EOF 



NAME: .EOF — Assembly termination directive. 

FORMAT: .EOF 

PARAMETERS: None. 



DESCRIPTION: The .EOF directive terminates the source program. 
Suissequent source lines are ignored and not included 
in the listing file or the object file. 

Hie .EOF directive is not required to terminate a 
source file. When the assembler encounters a 
ji^sical end of file, it is interrupted as a .EOF 
directive. An exception occurs if the assembler 
encounters a physical end of file inside an include 
file, then the next 'outer nested' file is read 
from. However, if the assembler encounters a .EOF 
inside an include file, all source line processing 
is terminated at that point. 
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.ERROR .ERROR 



NAME: .ERROR — Error message print directive. 
FORMAT : . ERROR " <message> " 

PARAMETERS: 

<lnessage> = any legal character string. Null strings are 
allowed. 



DESCRIPTION: .ERROR causes the assembler to display an error 
message on standard error and in the listing file 
(if ^^plicable). .ERROR can be used to display an 
error message when a macro call or conditional 
assembly contains an undesirable set of conditions. 

User-generated error messages have the form: 

** <name>-Error <f ile_name> [User-generated] : <lnessage> 

Where: 

<name> = to the assembler name. 

<f ile_name> = to the source file that 

generated the error message. 
<message> = to message string to be printed 

The * [User-generated] ' distinguishes it f ran error 
messages generated ty the assembler. The double 
quotes C) do not appear as part of the printed 
message. 

When the assembly is finished, the assembler 
displays the total nuniber of errors encountered, 
this includes both assembler and user-generated 
errors. 



NOTES: 



1. The line containing the .ERROR directive is not 
included in the listing file. 
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.ERROR (Continued) .ERROR 



7-31 



ASSEMBLER DTRECTIVES 
**** PRELIMINARY - For internal use only **** 



.EXTERN .ESCTEPN 



NAME: .EXTERN — External symbol definition directive, 

EDRMAT: .EXTERN <syinbol> {,<symbol>} 

PARAMETERS: 

<syinbol> = any legal user-defined symbol. 



DESCRIPTICN: Hie .EXTERN directive indicated that the specified 
symbols are external to this module. 

If the EXTERNAL keyword is enabled (see the 
description of .ENABLE) , all unresolved symbols are 
declared external. Ihus, if EXTERNAL is enabled, 
the progranimer need not specify symbols as external 
using the .EXTERN directive. However, if EXTERNAL 
is disabled, the progrsnimer must explicitly use 
.EXTERN to declare any symbols that are defined 
externally but referred to in the current module. 
If EXTERNAL is disabled and the assanbler finds 
symbols that are not defined in the current module 
and are not listed in a .EXTERN directive, an error 
message is printed. 

If a symbol is declared as external, and then 
defined in the current module, an error message is 
printed. 

If multiple symbols are specified, they must be 
separated by commas. 



NOTES: 



1. This directive must appear inside a module (see 
.MDDDLE). 
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.FATAL .FATAL 



NAME: .FATAL — Fatal message print directive. 

FORMAT: .FATAL "<lnessage>" 

PARAMETERS: 

<inessage> = any legal character string. Null strings are 
allowed. 



DESCRIPTICN: .FATAL causes the assembler to display a fatal 
message on standard error and in the listing file 
(if applicahle) . .FATAL can be used to display an 
error message when a macro call or conditional 
assembly contains a disastrous set of conditions. 

User-generated fatal messages have the form: 

** <name>-Fatal <f ilejiame> [User-generated] : <3nessage> 

Where: 

<name> = to the assembler name, 
<file_jTame> = to the source file that 

generated the fatal message. 
<message> = to message string to be printed 

•Hie ' [User-generated] ' distinguishes it from fatal 
messages generated ty the assembler. Ihe double 
quotes (") do not appear as part of the printed 
message. 

The .FATAL directive causes the assembler to 
iiimediately abort in pass one and no pass two 
processing will occur. All source line processing 
terminates at that point. 



NOTES: 



1. The line containing the .FATAL directive is not 
included in the listing file. 
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*ieie* 



.FATAL 



(Continued) 



.FATAL 



2. The assembler exit value will be set an error value. 
This value is operating syston depenc3ent. 
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.FILE .FILE 



NAME: .FILE — Source file definition directive. 

FORMAT: .FILE <niinlDer> [,"<name>" [,<modify__tiine>]] 

PARAMETERS: 

<number> = any legal integer nunnber. The file nunnber is 
represented as a unsigned integer and has the range 
of through +4294967295. Negative nimbers and 
expressions are not allowed. 

<name> = any legal character string. Null strings are not 
allowed. This parameter is optional. 

<modify__tiine> = any legal integer number. The modify time is 
represented as a signed integer and has the range of 
-2147483648 through +2147483647. Ihe default modify 
time is zero. ihis parameter is optional. 
E:q)ressions are not allowed. 



EESCRIETICTJ: The .FILE directive is used to control the source 
file name that is displ^ed whenever an error 
message is issued ty the linker or the runtime 
loader. This information is also used fcy the 
debuggers. 

The optional <name> and <lnodify__time> are only 
necessary when the first reference to the file is 
made. If the first reference does not include a 
file name, an assembler error will result. 
Subsequent references only need to specify the 
<nurtiber>. 



NOTES: 



1. The assembler does not enforce any path or file 
naming convention. This is specified by the 
host operating systan. 

2. The double quotes (") are not passed as part of 
the file name. 
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•FILE (Continued) .FILE 



3. File nunbers can be redefined by specifying a new 
file name to the nuntiber. 
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**ifk 



• GLCBAL 



.GLCBAL 



mm: 



.GLCBAL — Global symbol declaration directive. 



FORMAT: 



.GLCBAL <syiiibol> {,<syinbol>} 



PARAMETE3?S: 

<syinbol> = any legal user-defined symbol. 



IXSCRIPriCN: The .GLCBAL directive indicates that the specified 
symbols are declared as global symbols and are 
exported one level out (made visible outside the 
current module) . 

If multiple symbols are specified, they must be 
separated by commas. 



NOOES: 



1. Ihis directive must^a^^ar inside a module (see 
.MDIXJLE) . 

2. If a symbol is declared global, but not defined 
in the current module, an error is printed. 
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.HEAEEIR .HEADER 



NAME: .HEAEER — Listing header c3irective. 

FORMAT: .HEADER "<string>" 

PARAMETERS: 



<string> = any legal character string. Null strings are 
allowed. 



EESaUFFICN: The .HEADER directive causes the assembler to print 
the <sting> on the third line of each page of the 
listing file. A null <string> will clear or blank 
the previous header sting. Ihis directive is 
ignored if no listing file was specified. 



NOTES: 



1. Ihe .HEADER directive takes affect on the next 
listing page generated, unless it is the first 
opcode on the page.' 

2. Ihe header string can be up to 254 characters 
long, however, it is reoammended that it is 
limited to the width of the listing page. 

3. Ihe .HEAMIR string is initially set to the null 
string (blank) . 
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*itie* 



.IF 



.IF 



NAME: 



.IF — Conc3itional assembly if directive. 



FORMAT: 



.IF 



<expression> 



PARAMETERS: 

<e:^ression> = any legal e:^ression. The expression cannot 
contain any forward references, external symbols, 
relative symbols, or unresolved symbols. The 
expression must evaluate to an assemble- time 
constant in the first pass. 



DESCRIETION: 



A conditional assembly block is a series of source 
statements that is assembled only if a certain 
condition is met at assembly- time. .IF starts the 
conditioral block and .ENDC ends the conditional 
block. An optioral .ELSE can appear between .IF and 
.ENDC. Each .IF must have an corresponding .ENDC. 
The .IF directive contains an expression which is 
evaluated (as 32-bits)-. If the result is nonr-zero, 
all the source lines \jp until the .ELSE or .ENDC 
directives are assembled. If the expression 
evaluates to zeror all source lines up until the 
.ELSE or .ENDC directives are skipped. If a .ELSE 
directive is encountered, then the lines between the 
.ELSE and .ENDC are assembled. 



Conditional blocks can be nested, that is a 
conditioral block can be inside of another 
conditioml block. In this case the statements in 
the inner conditional block are assembled only if 
the condition is met for both the outer and inner 
block. .IF directives can be nested 16 levels deep. 
If a statonent attempts to exceed this nesting level 
depth, the assembler displays an error message. 
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.IF (Continued) .IF 



NOTES: 

1. 
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.INCLD 



.INCIiD 



NAME: 
FORMAT: 



INOiD — Include file directive. 



INCLD "<file_jiame>' 



PARAMETERS: 
<f ile name> 



any legal character string. Null strings are not 
allowed. 



EESCRIPriC^: The .INOiD directive includes the <file_jiame> in the 
source stream. Include files may be nested. If a 
.EOF directive is encountered in an include file, 
all subsequent source lines are ignored. Nested 
.INCLD are allowed to 16 levels. 



NOTES: 



1. 
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.LINE 



.LINE 



NAME: 



.LINE — Source line nuniber definition c3irective. 



FORMAT: 



.LINE [+I-] [<ntinber>] 



PARAME1ERS: 
<nijnber> 



any legal integer nuniber. The line nunniDer is 
represented as a unsigned integer and has the range 
of through +4294967295. This parameter is 
optional. Negative nunbers and expressions are not 
allowed. 



rasCRIETIQN: The .LINE directive is used to control the line 
nunber that is displayed whenever an error message 
is issued by the linker or the runtime loader. This 
information is also used by the debuggers. 

The various functions of the .LINE directive are 
suranarized in Table 7-7. 



Table 7-7: 



Directive 



Description 



.LINE 
.LINE - 
.LINE + 

.LINE <number> 
.LINE -<nun[iber> 



Incronent the current source line 
nunber ty one. 

Decrement the current source line 
nunber ty one. 

Incronent the current source line 
nuniber ty one. 

Set the source line nun[±)er to 
<nunber>. 

Set the source line nunber to the 
current source line nunber minus 
<nunber>. 
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.LINE 



(Continued) 



Table 7-7: 



.LINE 



Directive 



Description 



.LINE +<number> I Set the source line nunber to the 
I current source line nunber plus 
<niinber>. 



NOTES: 



1. 
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.LINKER .LINKER 



NAME: .LINKER — Linker directive. 

FORMAT: .LINKER <value> {,<value>} 

PARAMETERS: 

<value> = any legal expression. The e^^ression can contain 
forward references, but cannot contain any external, 
relative or unresolved symbols. The expression must 
evaluate to an assemble- time constant. 



EESCRIETION: The .LINKER directive is used to pass information 
directly to the linker. Detailed knowledge of the 
object format is needed to used this directive. 
Extrane caution should be taken in using this 
directive. Refer to Appendix F for the effects of 
this directive on specific object files. 



NOTES: 

1. 
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.LIST 



.LIST 



NAME: 



.LIST — Listing control directive. 



FORMAT: 



.LIST <keyword> {,<keyword>} 



PARAMETERS: 
<keyword> 



any keyword listed in Table 7-8. Either the long 
form or short form of the keyword can be used. 



EESOHETION: .LIST and its negative form, .NCLIST, specify 
listing control options in the source text of a 
program. .LIST causes certain types of lines to be 
included in the listing file. 

Each keyword can be used alone or in combination 
with other keywords. If multiple keyword are 
specified, they must be separated ty commas. 



Table 7-8: 



Long 
Form 


Short 
Form 


Default 
Condition 


Description 


PA3E 


PG 


List 


Enable the use 
of the .PAGE 
directive. 


GOroiTIONS 


CA 


List 


Not implemented. 


DEFINITION 


MD 


List 


Not implemented. 


CAT.r.S 


MC 


List 


Not implemented. 


EXPANSIONS 


ME 


List 


Not implonented. 


SOURCE 


f^, 


List 


List source lines. 


TSTATES 


TS 


List 


Not implonented. 
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.LIST 



(Continued) 



.LIST 



Table 7-8: 



Long 
Form 



Short 
Form 



Default 
Condition 



Description 



WIOVT 



WS 



No List 



Print the WICAT 
proprietary 
statement on the 
second line of 
each listing page. 
Tliis statement 
will be printed 
on every listing 
pager regardless 
of where the .LIST 
directive is 
encountered. 



NOTES: 



1. 



7-46 



**** 



ASSEMBLER niRECriVES 
PRELIMINARy - For internal use only 



**** 



.LOCAL 



.LOCAL 



NAME: 



.LOCAL — Local symbol declaration directive. 



FORMAT: 



.LOCAL <syinbol> {r<syinbol>} 



PARAME^IERS: 

<syinbol> = any legal user-defined symbol. 



DESCRIPTION: The .LOCAL directive indicates that specified 
symbols are declared as local symbols. If a symbol 
is not declared as a .GLOBAL or .EXTERN, then it is 
assumed to be local. If a symbol is declared, but 
never defined (e.g. as a label) , an error is 
printed. 

.LOG\L is the default for all symbols. 



NOTES: 



1. Tliis directive must appear inside a module (see 
.^DEDLE) . 
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.MDEDLE .^DIXJLE 



NAME: .MDDCJLE — Module definition directive. 

FORMAT: .MDDDLE [<name>] 

PARAME!IERS: 

<name> = any legal user-defined symbol. The default name is 
the null name (null string) . Ihis paraneter is 
optional. 



lESCRlFIJCHHi ihe .MDEDLE directives is used to begin a new 
procedure or subroutine. Each module defines a new 
scoping symbol environent. Any previous defined 
section (see. SECT) is pushed onto the section 
stack. Modules may be nested. 



NOTES: 

1. 
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.NCLIST 



.NCLIST 



NAME: 



.NCLIST — Listing control directive. 



FORMAT: 



.NQLIST <keyword> {,<keyword>} 



PARAMETERS: 
<keyword> 



ai^ keyword listed in Table 7-9. Either \±ie long 
form or short form of the keyword can be used. 



EESCRIPTIDN: .NCLIST specify listing control options in the 
source text of a progrcm. .NCLIST causes certain 
types of lines to be excluded in the listing file. 

Each k^word can be used alone or in combination 
with other keywords. If multiple keyword are 
specified, they must be separated fcy commas. 



Table 7-9: 



Long 
Form 


Short 
Form 


Default 
Condition 


Description 


PAGE 


PG 


List 


Disable the use of 
.PAGE. 


CONDITIONS 


CA 


List 


Not implonented. 


DEFINITION 


MD 


List 


Not implemented. 


CATJJS 


MC 


List 


Not implonented. 


EXPANSIONS 


ME 


List 


Not implonented. 


SOJRCE 


SL 


List 


Do not list source 
lines. 


TSTATES 


IS 


List 


Not implonented. 
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**** 



.NQLIST 



(Continued) 



.NCLIST 



Table 7-9: 



Long 
Form 



Short I Default | 

Form I Condition j Description 



WICAT 



I WS 1 No List i 



Do not list the 
WICAT proprietary- 
statement. 



NC7IES: 



1. 
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.NCNUSR .NCNUSR 



NAME!: .NCNUSR — Non-user symbol declaration directive, 

FORMAT: .NCNUSR <syinbol> {,<syinbol>} 

PARAMETERS: 

<symbol> = aiiy legal user-defined symbol. 



JJESCRlFIlCMi The .NCNUSR directive indicates that specified 
symbols are declared as non^user defined symbols. 
This directive is useful for distinguishing user 
defined symbols form nonruser defined symbols (e.g. 
compile symbols) . By default, non-user symbols not 
included in object files. 

If the USER keyword is disabled (see the description 
of .DISABL) , all undeclared symbols will be assuned 
to be declared as nonrniser symbols (see .NCNUSR) . 
Ihus, if the USER keyword is disnabled, the 
programmer need not specify symbols as non-user 
using the .NCNUSR directive. Hcwever, if USER is 
enabled (the default) , the progrcnimer must 
explicitly use .NCNUSR to declare air/ symbols that 
are not defined by the user symbols in tiie current 
module. 

If a symbol is declared as non-user, but never 
defined (e.g. as a label) , an error will be 
reported. 

If multiple symbols are specified, they must be 
separated by commas. 



NOTES: 



1. This directive must appear inside a module (see 
.MODULE) . 
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.PAGE .PAGE 



NAME: .PA3E — Page advance directive, 
FORMAT: .PAGE 
PARAMETERS : None . 



EESCRIPTIC^: The .PAGE directive advances the listing file to the 
top of the next page. This is acoompLished ty 
writing a Form Feed (Ij) character into the listing 
file. If the listing file is printed on a device 
that does not support the Form Feed character, the 
use of the .PA3E directive is ineffective. 
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.PRINT .PRINT 



NAME: .PRINT — Print message directive. 

FORMAT : . PRINT " <5nessage> " 

PARAMETERS: 

<lnessage> = any legal character string. Null strings are 
allcwed. 



EESCRIPTiraJ: .PRINT causes the assembler to display an 
informational message on standard error and in the 
listing file (if applicable) . .IRINT can be used to 
display an informatioral message. The message 
produced by .PRINT is not considered an error or 
warning message. 

User-generated messages have the form: 

** <name>-Print <f ile_jiame> [User-generated] : <message> 

Where: 

<name> = to the assembler name. 

<f ile_name> = to the source file that 

generated the message. 
<message> = to message string to be printed 

The ' [User-generated] ' distinguishes it fran 
messages generated ty the assembler. The double 
quotes (") do not appear as part of the printed 
message. 



NOTES: 



1. Ihe line containing the .PRINT directive is not 
included in the listing file. 
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**** 



.EROCSS 



.mocss 



NA^: 



.ERCXSS — Processor definition directive. 



FORMAT: 



.HIOCSS <type> 



PARAMETE3?S: 
<type> = any processor type listed in Table 7-10. 



EESCRIPriOI: The .PRCXSS directive causes the assembler to 
accepts only the instructions and addressing modes 
of the specified processor. 



Table 7-10: 



Long 
Form 



I Short I 

I Form I Description 



M68000 



M68020 



MO I Accept the M68000 instructions 
I and addressing modes. 



M2 



Not impLonented. 



NOTES: 



1. 
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.SECT 



.SECT 



NAME: 



.SECT — Section definition directive. 



FORMAT: 



.SECT <ntinber> {,<attribute>} 
. SECT <name> { , <attr ibute> } 



PARAMETERS: 
<nu[nber> 



ary legal integer nunber. The section nimber must 
be in the range of through 254. Negative nimbers 
and expressions are not allowed. 



<name> = any legal user-defined symbol. 

<attribute> = any attribute listed in Table 7-11. Either the long 
form or short form of the attribute can be used. 



DESGRIPriOJ: 



The directive .SECT defines a section and its 
attributes. When the <name> parameter is used, the 
name must be either a predefined section name (see 
Table 7-12) , or have be defined previously with the 
NAM! attribute. Ihe <number> parameter specifies 
the section nunber. 

Each section can be defined to have the attributes 
listed in Table 7-11. However, once a section is 
defined, conflicting attributes are not allowed. 



Table 7-11: 



Long 


Short 




Form 


Form 


Description 


ABSCLUTE 


AS 


The linker assigns the 
section to be absolute. 
•Hie contents of this 
section can be code or 
data. The default 
section type is 
relative (see 

RFI.AM'IVF.) . 
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.SECT 



(Continued) 



.SECT 



Table 7-11: 



Long 


Short 




Form 


Form 


Description 


RFI.ATIVE 


RS 


•Hie linker assigns the 
section tr^pe to be 
relocatable. The 
contents of this 
section can be code or 
data. This is the 
default section type. 


ADERESS = <value> 


AD 


Set the beginning 
address of this section 
to <value>. The default 
beginning address is 
zero. 


nam: = <syinbol> 


NM 


Assign <symbol> as the 
name of this section. 



Table 7-12: Predefined Section Names 



Name 



Attributes 



TEXT 


RFTATWE 


DATA 


RFI.ATTVE 


BSS 


RFIiATWR 


CSTR 


RFIiATlVR 


HJRE 


RFI.ATTVR 


IMHJRE 


RFTiATWR 



NOTES: 



1. Ihis directive must appear inside a module 
.MDDCJLE). 



(see 
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2. The ABSCLOTE and ADERESS keyworc3s are not 
supported ty all object file formats. Refer to 
Appendix F for specific object file limitations. 
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.STODCr .STRUCT 



NAME: .sraDCT — Structure definition directive. 

FORMAT: .STODCT <name> 

PARAMETERS: 

<name> = any legal user-defined symbol. 

EESCRIETIDN: Not si^jported in this version. 
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.USER .USER 



NAME: .USER — User symbol cief inition directive, 

FORMAT: .USER <syinbol> {,<syinbol>} 

PARAMETERS: 

<syinbol> = any legal user-defined symbol. 



DESaHETiai: The .USER directive indicates that specified symbols 
are declared as user defined symbols. ^is 
directive is useful for distinguishing user defined 
symbols form non-user defined symbols (e.g. oranpile 
symbols) . By default, non-user symbols not included 
in object files. 

If the USER keyword is disabled (see the description 
of .DISABL) , all undeclared symbols will be assuned 
to be declared as non-user symbols (see .NCNUSR) . 
Ihusr if the USER keyword is enabled, the programmer 
need not specify symbols as user using the .USER 
directive. However, if USER is disabled, the 
programmer must e:^licitly use .USER to declare any 
symbols that are defined as user symbols in the 
current module. 

If a symbol is declared as user, but never defined 
(e.g. as a label) , an error will be reported. 

If multiple symbols are specified, they must be 
separated fcy commas. 



NOIES: 



1. This directive must appear inside a module (see 
.MDDULE) . 
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•WARN .WARN 



NAME: .WARN — Warning message print directive. 

FORMAT : . WARN " <message> " 

PARAMETERS: 

<inessage> = ary legal character string. Null strings are 
allo/ed. 

DESCRIPTION: .WARN causes the assembler to display a warning 

message on standard error and in the listing file 

(i£ applicable) . .WARN can be used to display a 

warning message whai a macro call or conditional 

assembly contains a questionable set of conditions. 

User-generated warning messages have the form: 

** <name>-Wam <f ile_jTame> [User-generated] : <n:iessage> 

Where: 

<name> = to the assembler name. 

<f ile_jiame> = to the source file that 

generated the warning message. 
<message> = to message string to be printed 

The ' [User-generated] ' distinguishes it f ran warning 
messages generated by the assembler. Ihe double 
quotes C) do not appear as part of the printed 
message. 

When the assembly finishes r the assembler displays 
the total nunnber of warning encountered, this 
includes both assembler and user-generated warnings. 



NOTES: 



1. The line containing the .WARN directive is not 
included in the listing file. 
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•WEAK .WEAK 



NAME: .WEAK — Weak symlDol declaration directive, 

FORMAT: .WEAK <syn\bol> {,<syinbol>} 

PARAME1ERS: 

<syinbol> = ai^ legal user-defined symbol. 



msailPriON: .WE2\K specifies that references to the name 
symbol (s) may be allowed to be unresolved during the 
link editing process. If a .WEAK symbol is 
resolvedf the .WEAK directive has the same effect as 
.EXTERN. If the symbol is unresolved during 
linking, references to it are set to the default 
value of -1 (NOTE: this value may be changed at 
link-time. See the linker documentation information 
on how to modify the default value.) . The linker 
does NOT report an error for unresolved weak 
symbols. 

When .WEAK specifies a symbol that is defined in the 
current visible scope, then that definition is used, 
and the symbol is considered defined. In this case, 
the .WEAK declaration has no meaning. 

If a weak symbol is not referenced in the current 
scope, then an error is reported. 

If multiple symbols are specified, they must be 
separated fcy commas. 



NOTES: 



1. Ihis directive must appear inside a module (see 
.MODDLE) . 

2. Ihis directive is not st^jported by all object 
file formats. Refer to Appendix F for specific 
object file limitations. 
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[To be written later] 
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[To be written later] 
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APEENDIX A 
ASCII CHARACTER TMLE 



c 





D 


HI 


C 





D 


HI 


C 





D 


HI 


C 





D H 


K 


[ 


c 


E 


EI 


H 


C 


E 


E 


H 


c 


E 


E 


H 


C 


E E 


R 


T 


C 


XI 


R 


T 


C 


X 

1 


R 


T 


c 


X 


R 


T 


C X 


NOL( 


-@) 


000 





001 


SP 


040 


32 


201 


@ 


100 


64 


40 


1 


140 


96 60 


SCH( 


^A) 


001 


1 


oil 


I 


041 


33 


211 


A 101 


65 


411 


a 


141 


97 61 


STX< 


^B) 


002 


2 


021 


n 


042 


34 


22 


B 


102 


66 


42 


b 


142 


98 62 


. ETX 


[^C) 


003 


3 


031 


# 


043 


35 


23 


C 


103 


61 


43 


c 


143 


99 63 


EOT 


[^) 


004 


4 


041 


$ 


044 


36 


24 


D 


104 


68 


44 


d 


144 


100 64 


£NQ< 


-^E) 


005 


5 


051 


% 


045 


37 


25 


E 


105 


69 


45 


e 


145 


101 65 


ACK 


rF) 


006 


6 


061 


& 


046 


38 


26 


F 


106 


70 


46 


f 


146 


102 66 


BEL( 


^G) 


007 


7 


071 


f 


047 


39 


27 


G 


107 


71 


47 


g 


147 


103 67 


BS { 


^) 


010 


8 


081 


( 


050 


40 


28 


H 


110 


72 


48 


h 


150 


104 68 


HT 


ri) 


Oil 


9 


091 


) 


051 


41 


29 


I 


111 


73 


49 


i 


151 


105 69 


LF 


rj) 


012 


10 


OA 


it 


052 


42 


2A 


J 


112 


74 


4A 


j 


152 


106 6A 


VT 


CK) 


013 


11 


OB 


+ 053 


43 


2B 


K 


m 


75 


4B 


k 


153 


107 6B 


FF 


CD 


014 


12 


OC 


f 


054 


44 


2C 


L 


114 


76 


4C 


1 1 


154 


108 6C 


CR 


("M) 


015 


13 


OD 


- 


055 


45 


2D 


1 M 


115 


77 


4D 


m 


155 


109 6D 


SO 


(^) 


016 


14 


OE 


• 


056 


46 


2E 


N 


116 


78 


4E 


; n 


156 


110 6E 


SI 


(^0) 


017 


15 


OF 


/ 057 


47 


2F 


1 


117 


79 


4F 





157 


111 6F 


DLE 


(^P) 


020 


16 


10 





060 


48 


30 


P 


120 


80 


50 


P 


160 


112 70 


DCl 


(^Q) 


021 


17 


11 


1 


061 


49 


31 


Q 121 


81 


51 


q 


161 


113 71 


DC2 


(^R) 


022 


18 


12 


2 


062 


50 


32 


R 122 


82 


52 


r 


162 


114 72 


DC3 


[^S) 


023 


19 


13 


3 


063 


51 


33 


S 


123 


83 


53 


s 


163 


115 73 


DC4 


[^) 


024 


20 


14 


4 


064 


52 


34 


T 124 


84 


54 


t 


164 


116 74 


NAK 


("U) 


025 


21 


15 


5 


065 


53 


35 


U 


125 


85 


55 


u 


165 


117 75 


SYN 


CV) 


026 


22 16 


6 


066 


54 


36 


V 126 


86 


56 


V 


166 


118 76 


h'JB 


[^) 


027 


23 


17 


7 


067 


55 


37 


W 127 


87 


57 


w 


167 


119 77 


CAN 


[^) 


030 


24 


18 


8 


070 


56 


38 


X 


130 


88 


58 


X 


170 


120 78 


EM 


(^) 


031 


25 


19 


9 


071 


57 


39 


Y 


131 


89 


59 


y 


171 


121 79 


SUB 


[^Z) 


032 


26 


lA 


• 
• 


072 


58 


30 


Z 


132 


90 


5A 


z 


172 


122 7A 


ESC 


ri) 


033 


27 


IB 


• 
/ 


073 


59 3B 


1 [ 


133 


91 


5B 


1 { 


173 


123 7B 


FS 


(A) 


034 


28 


IC 


< 


074 


60 


3C 


1 \ 134 


92 


5C 


1 1 


174 


124 7C 


GS 


n) 


035 


29 


ID 


ss 


075 


61 


3D 


1 ] 


135 


93 


5D 


1 } 


175 


125 7D 


RS 


t ^^\ 


036 


30 


IE 


> 


076 


62 


3E 


1 ^ 


136 


94 


5E 


~ 


176 


126 7E 


US 


':^j 


037 


31 


IF 


• 


077 


63 


3F 


^M^ 


137 


95 


5F 


IRUB177 


127 7F 
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APHNDIX C 
ASSEMBLER SYNTAX SUMMARY 



This appendix describes the cxamplete assembler syntax in modified 
BacJcus-Naur Form (BNP) . Ohe following symbols are meta-symbols 
belonging to the-BNF formal ian: 

<> - Denotes a syntactic unit. 

Read as: the name enclosed in the angle 

brackets. 
::= - Definition of a syntactic unit. 

Read as: "is defined to be". 
I - Choose between syntactic units. 

This symbol can appear as part of the 

assembler language. 

Read as: "or". 
{} - Denotes possible r^jetition of the enclosed 

syntactic unit(s) zero or more times. 

Read as: "zero or more occurences of". 
[] - Optional syntactic unit(s). 

Read as: "optionally". 
<space> - Concatenation of two syntactic units. 

Read as: "followed by" 
- Terminal symbol range. 

Read as: "throu^" (implied "or" (I) between 

each element in the range. 

All other characters are part of the assembler language. 
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ASSEMBLER SYNTAX SUMMARY 
**** PRELIMINARY - For internal use only **** 

GENERAL ASSEMBLER SYNTAX SUMMARY: 



<file> 

<line> 

<label> 

<opcx)de> 

<operands> 

<operand> 

<canment> 

<e:^ression> 

<simpl e_e:5)r ession> 

<tenn> 
<f actor > 

<relation_operator> 

<simple_operator> 

<tenn__operator> 

<syinbol> 

<syinbol_start> 

<syinbol_bod7> 

<integer> 

<char ac±er__liter al > 

<character_unit> 

<niinber> 



= { <line> } 

= <label> <opcode> <operands> <caninent> 

= <syinbol>: I <empl:y> 

= <syiiibol> I <empty> 

= <operand> | <operand> { , <operand> } 

= <PR0CESS0E^i:EPENI2NT> | <€mpty> 

= ; { <character> } 

= <siinple_e3q)ression> I <siiiiple_e:5>ression> 
<relationu.operator> <siinpLe__expression> 

:= <tenn> I <sign> <tenn> I 

<siiiipLe_e:5)ression> <siiEple_operator> <term> 

:= <factor> | <term> <teniuoperator> <f actor > 

:= <syinbol> I <integer> I ( <expression> ) I 
~ <factor> I ! <factor> I ? <syinbol> I * 

= < I <= I = I <> I 1= I >= I > 

= + I - I '^ I I I 1 1 I 

= * I / I % I & I && I « I » 

= <symbol_jstart> <syinbol_body> 

= <letter> I . I _ 

= { <letter> I <caeciinal_digit> I . I _ I $ } 

= <character_literal> I <nunnber> 

= ' { <character__unit> } ' 

= <character> I \ <character> I 
\ '^ <character> I \ <niinber> 

:= <binary_jiiinber> I <octal_niiiiber> I 

<deciinal_jiiinber> I <hexadecimal_ptinber> I 
<int-real_niinber> 
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**** 



<binary_jiiinber> 



<octal_niinber> 



<deciinal_punber> 



<hexadeciiiial_niinber> ::= 



< int- real_jiunnber > 



^B <binary_dLgit> { <binary_digit> } | 
^b <binary_digit> { <binary__digit> } 

'0 <octal_c3igit> { <oct:al_c3igit> } I 
^o <octal_digit> { <octal_digit> } 

^D <deciinal__digit> { <deciinal_digit> } | 

M <decimal_digit> { <deciinal_digit> } I 

<deciinal_digit> { <deciinal_dLgit> } 

^H <hexadeciinal_digit> { <hexadeciinal_digit> } 

^h <hexadeciinal_digit> { <hexadeciinal_digit> } 

$ <hexadeciinal_digit> { <hexac3eciinal_digit> } 



<real> 

<wholejpart> 

<f r acti onal_part> 

<exponent> 

<sign> 

<string> 

<empty> 

<character> 

<letter> 

<binary_digit> 

<oc±al_digit> 

<declmal_digit> 

<hexadeciinal_digit> 



'R <real> 
'T <real> 
'F <real> 
'L <real> 
'U <real> 



^r <real> I 

't <real> I 

'f <real> I 

^1 <real> I 
^u <real> 



<whole_part> . <fractional_part> <e:q»nent> 

<deciinal_digit> { <deciinal_digit> } 

<c3eciinal_digit> { <deciinal_c3igit> } | 

<empty> 

E <sign> <decdLinal_cligit> { <deciinal_digit> } | 

e <sign> <deciinal_digit> { <deciinal_digit> } I 

<empty> 

+ 1-1 <empty> 

" { <character_unit> } " 



= ASai character set 

~ A* • z a* • z 

= 011 

= 0..7 

= 0..9 

= 0..9 I A..F I a..f 
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**** 



DIRECTIVE SWEAX SUMMARY: 



<label> 
<label> 



<label> 



.ABSAER 

.ADER 

.ALIGN 

.ALIGN 

.BEGIN 

.gomm:^ 

.GCNFIG 

.GCNST 

.DC.B 

.DC.W 

.DC.L 

.DC.F 

.DC.D 

.DISABL 

•DS.B 

.DS.W 

.D6.L 

.D6.S 

.ELSE 

.ENABLE 

.END 

.ENDC 

.£ND6 

.EOF 

.ERROR 

.EXTERN 

.FATAL 

.FILE 

.GLCBAL 

•HEAEGR 

.IF 

.INOiD 

.LINE 

.LINKER 

.LIST 

.LOCAL 

.MODULE 

.NCLIST 

.NCNUSR 

.PAGE 

.PRINT 

.PROCSS 

.SECT 

.SECT 

.SIHJCr 

.USER 

.WARN 

.WEAK 



<expression> [,<e:q)ression>] 

<expression> 

<expression> [,<e:^ression>] 

<syinbol> [,<e2^ression>] 

[<syinbol>] 

<synibol> [,<e:5)ression>] 

<string> 

<expression> 

<expression> {,<expression>} 

<expr ession> { , <e:^r ession> } 

<expression> {,<e:^ression>} 

<real> {,<real>} 

<real> {,<real>} 

<syinbol> {,<synibol>} 

<expression> [,<expression>] 

<expression> [,<e:^ression>] 

<e3^r ession> [ , <e:q)r ession> ] 

<expression> [,<e3q)ression>] 

<syinbol> {,<syinbol>} 
[<syiiibol>] 

[<syinbol>] 

<string> 

<syinbol> {,<syinbol>} 

<string> 

<integer> [,<string> [,<integer>]] 

<syinbol> {,<syinbol>} 

<string> 

<expression> 

<string> 

[+!-] [<integer>] 

<e:q)ression> {,<expression>} 

<:symbol> {,<syinbol>} 

<syinbol> {,<syinbol>} 

[<syinbol>] 

<syinbol> {,<syinbol>} 

<syinbol> {,<syinbol>} 

<string> 

<syinbol> 

<integer> {,<symbol>} 

<syinbol> {,<syinbol>} 

<syinbol> 

<syinbol> {,<syinbol>} 

<string> 

<syiiibol> {,<syinbol>} 
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APEENDIX D 
ASSEMBLER BLOATING RDINT FORMAT 

[TO be written later] 
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APIENDIX E 
68000 INSTRUCTION SET SUMMARY 



This appendix provides a sunmary of the 68000 instruc±ion set. 
For detailed information, refer to the 

Motorola MC680Q0 16-bit Microprocessor n.ser's Manual. 



E-1 



68000 INSTRUCTION SET SUMMARY 
**** PRELIMINARY - For internal use only **** 



ABCD 


EH, Eh 




-(An), -(An) 


ADD 


<ea>,Eh 




Eii,<ea> 


ADEA 


<ea>,An 


ADDI 


#<data>,<ea> 


ADEQ 


#<(iata>,<ea> 


ADDX 


Dn,Qi 




-(An), -(An) 


AND 


<ea>,Qi 




Eii,<ea> 


ANDI 


#<data>,<ea> 




#<data>,CCR 




#<data>,SR 


ASL 


EH, Eh 




#<c3ata>,Eh 




<ea> 


ASR 


Eh,Eh 




#<data>,Dn 




<ea> 


BCC 


aabel> 


BCS 


<label> 


RFQ 


<label> 


BF 


<label> 


BGE 


<1 ahPl > 


BGT 


<label> 


BHI 


<label> 


BHS 


<label> 


RT.R 


aabel> 


RTO 


aabel> 


BLS 


<labPl> 


RT.T 


<label> 


BMI 


<label> 


BNE 


<label> 


BHi 


<label> 


BT 


<1 ahpl > 


BVC 


<label> 


BVS 


<label> 


BCHG 


Eh,<ea> 




#<data>,<ea> 


BCLR 


Dn,<ea> 




#<c3ata>,<ea> 


BRA 


<label> 


BSET 


Eh,<ea> 




#<data>,<ea> 


BSR 


<label> 


BTST 


En,<ea> 




#<data>,<ea> 


CHK 


<ea>,En 


OiR 


<ea> 


CMP 


<ea>,Eii 
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68000 INSTRUCTION SET SUMMARY 
**** EE^BLIMINARY - For internal use only **** 



CMPA <ea>,An 
CMPI #<c3ata>,<ea> 
CMPM (An)+,(An) + 
EBCC Ehr<label> 
EBCS En,<label> 
DBBQ Qir<label> 
IBF Dn,<label> 

DBGE Di,<label> 
DBGT Eiir<label> 
DBHI Di,<label> 
mm Eiir<label> 
DBLE Qi,<label> 
DBLO Dir<label> 
DELS Eh,<label> 
IBLT Dir<label> 
DBMI Qir<label> 
DBNE Eiir<label> 
IBHi Di,<label> 
DBPA En,<label> 
IBT Qi,<label> 

DBVC Eh,<label> 
IBVS Enr<label> 
DIVS <ea>,Di 
DIVU <ea>,Eh 
EOR En,<ea> 
EORI #<data>,<ea> 

#<c3ata>,CC3l 

#<data>,SR 
EXG Rn,Rn 

EXT Eh 

ILLB3AL 
JMP <ea> 

JSR <ea> 

LEA <ea>,An 

LINK Anr#<data> 
LSL EUfDi 

#<data>,ni 

<ea> 
LSR En, Eh 

#<data>,Eh 

<ea> 
MOTE <ea>,<ea> 

<ea>,CCR 

<ea>,SR 

SR, <ea> 

AnrUSP 

USP,An 
ICVEA <ea>,An 



PLVJiA <;ea>,An 
MD7EM <register_list>f<ea> 
<ea> , <register_list> 
MOTEP Eh,d(An) 
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**** 



68000 INSTRDCTICN SET SUMMARY 
PRELIMINARY - For internal use only 



**** 





d(An)rDi 


MDVtU 


#<c3ata>,Qi 


MJLS 


<ea>,Eli 


MDLU 


<ea>,Qi 


NBCD 


<ea> 


NBG 


<ea> 


NBGX 


<ea> 


NOP 




Nor 


<ea> 


OR 


<ea>,ai 




Dir <ea> 


ORI 


#<data>,<ea> 




#<data>,CCR 




#<data>,SR 


FEA 


<ea> 


RESET 




RCL 


EhrEH 




#<data>,Eh 




<ea> 


ROR 


EftfEh 




#<data>,En 




<ea> 


RQXL 


EhfEh 




#<c3ata>,Di 




<ea> 


RQXR 


QifEh 




#<data>,Qi 




<ea> 


RTE 




RTR 




BUS 




SBCD 


Eh, Eh 




-(An), -(An) 


sec 


<ea> 


SCS 


<ea> 


SEQ 


<ea> 


SF 


<ea> 


SGE 


<ea> 


9GT 


<ea> 


SHI 


<ea> 


SHS 


<ea> 


SLE 


<ea> 


SLO 


<ea> 


SLS 


<ea> 


SLT 


<ea> 


SMI 


<ea> 


SNE 


<ea> 


SIL 


<ea> 


SRA 


<ea> 


ST 


<ea> 


SVC 


<ea> 



E-4 



68000 INSTRDCriON SET SUMMARY 
**** PRELIMINARY - For internal use only **** 



S7S <ea> 

STOP #<c3ata> 



SCB <ea>,En 

Eli,<ea> 

SUBA <ea>,An 

SDBI #<data>,<ea> 

SOBQ #<data>,<ea> 

SC3BX DnrEh 

-(An), -(An) 

SWAP En 

TAS <ea> 

TRAP #<vector> 
TRAP7 

IST <ea> 

UNLK An 
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APPENDIX F 
OBJECT FILE MD LINKER LIMITATIONS 

[To be written later] 
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